arrow-up icon

Prerequisite preparations

This chapter describes the prerequisite preparations for running Siderscan.

Create Sidrescan install directory

Create a directory to install Siderscan. In this document, the install directory is assumed as /home/sideruser/siderscan

$ mkdir /home/sideruser/siderscan

Deploy configuration files

Save the following files in the directory created above.
If you do not have the configuration file, please request it us at the application form.

  • .envPrefix file of the container created by docker-compose up
  • docker-compose.ymlConfiguration file to run Docker container

Verify that the file has been saved with the following command:

$ cd /home/sideruser/siderscan
$ ls -al
.env
docker-compose.yml

Modify Configuration Files

Change the URL of analysis results

Write down the URL to display Siderscan analysis results in the .env file with the following format:

# Application URL
APP_URL=http://localhost
  • * When you run Siderscan on your local computer and see the analysis results on the local, please write http://localhost
  • * When you run Siderscan on a remote server, please write the server name or IP address of the server instead of http://localhost.

Change the Activation Code

To enhance security, we recommend that you should authenticate with an activation code when creating an administrator user.
If you do not need the authentication, just delete the code.

How to disable the Activation Code

In .env file, please delete ACTIVATION_CODE line.

How to use the Activation Code

In .env file, the default value of ACTIVATION_CODE is”activation1234”. Please change the activation code and save it.

# Used to create an administrator when the application is launched for the first time.
ACTIVATION_CODE=activation1234

Fetch source code for analysis

Create a directory in which to fetch the source code to be analyzed and change the permissions.

$ mkdir -p /home/sideruser/siderscan/var/targets
$ chmod 757 /home/sideruser/siderscan/var

Next, go to the targets directory and fetch the source code. This is an example command to get the source code with git clone.

$ cd /home/sideruser/siderscan/var/targets
$ git clone {repo}

Now, you are ready to use Siderscan!