Download and Install Arcan
This is the quickstart guide to install and run the first analysis with Arcan. See the complete reference for the alternative installation without Docker.
- Docker Engine >= 20.10 (See https://docs.docker.com/engine/install)
- Docker Compose (See https://docs.docker.com/compose/install/)
How to run Arcan locally
- Clone or download Arcan from Github.
- Fill in this form. You will receive the license at the provided email address.
- Open the email and download the attached
- Copy the
ArcanLicence_YYYYMMDDlicence file to the licences directory.
Configure the environment
- Copy the content of the .env.example file into a new file named
- Change the value of the variable
ARCAN_LICENCE_FILENAMEwith the name of licence file you copied in the licences directory.
- To run the Arcan dashboard and the server, open your favourite terminal and navigate to the
/arcan-trialfolder. Within the folder execute:
docker compose up.
- You will find the dashboard at http://localhost:3000.
Create and analyse a new project
Open Arcan dashboard at http://localhost:3000.
Click the "ADD NEW " button to analyse a new project.
- Fill out the form on the "Add new project" page with the project's name and the programming language you want to analyse.
- Indicate the location of the project you want to analyse:
- To analyse a remote project, use the remote repo URL when creating a new project. If the repository is private, remember to use a personal access token as password by ticking the "Project requires authentication" box (see How to analyse a remote repository for more info).
- To analyse a local project, copy the project folder into
/arcan-trial/projects. When creating a new project, specify the path to analyse as follows:
./projects/<folder_name>(see How to analyse a local repository for more info).
- In "Configure analysis" click on "ANALYSE" and then "CONTINUE" to trigger the analysis. Once the analysis is completed, you can interact with the project card on the "My projects" page.
On top of running Arcan from the Dashboard, you can also attach Arcan to a Continuous Integration (CI) pipeline. For instance, you can add Arcan to your Gitlab or Github pipelines. See the instructions for additional details.
If you find a bug or want to suggest a new feature create a new issue on Github: https://github.com/Arcan-Tech/arcan-issues-public. If you need further support or want to know more about Arcan, contact us at firstname.lastname@example.org or leave a message on our website.