Skip to content

Latest commit

 

History

History
72 lines (60 loc) · 4.78 KB

INSTALL.md

File metadata and controls

72 lines (60 loc) · 4.78 KB

Installation

Prerequisites: Python 3, SQLite 3
Although CTFOJ can run on Linux, Windows, and MacOS, it is recommended to run it on a modern Linux distribution.

It is recommended to create a venv (virtual environment) first.

Initial setup

The setup process involves 3 main steps:

  1. Install dependencies
  2. Create database
  3. Configure application

  1.

$ pip3 install -r requirements.txt
$ sqlite3 database.db
sqlite3>
CREATE TABLE 'users' ('id' integer PRIMARY KEY NOT NULL, 'username' varchar(20) NOT NULL, 'password' varchar(64) NOT NULL, 'email' varchar(128), 'join_date' datetime NOT NULL DEFAULT (0), 'admin' boolean NOT NULL DEFAULT (0), 'banned' boolean NOT NULL DEFAULT (0), 'verified' boolean NOT NULL DEFAULT (0), 'twofa' boolean NOT NULL DEFAULT (0));
CREATE TABLE 'submissions' ('sub_id' integer PRIMARY KEY NOT NULL, 'date' datetime NOT NULL,'user_id' integer NOT NULL,'problem_id' varchar(32) NOT NULL,'contest_id' varchar(32), 'correct' boolean NOT NULL);
CREATE TABLE 'problems' ('id' varchar(64) NOT NULL, 'name' varchar(256) NOT NULL, 'point_value' integer NOT NULL DEFAULT (0), 'category' varchar(64), 'flag' varchar(256) NOT NULL, 'draft' boolean NOT NULL DEFAULT(0));
CREATE TABLE 'contests' ('id' varchar(32) NOT NULL, 'name' varchar(256) NOT NULL, 'start' datetime NOT NULL, 'end' datetime NOT NULL, 'scoreboard_visible' boolean NOT NULL DEFAULT (1));
CREATE TABLE 'announcements' ('id' integer PRIMARY KEY NOT NULL, 'name' varchar(256) NOT NULL, 'date' datetime NOT NULL);
CREATE TABLE 'contest_users' ('contest_id' varchar(32) NOT NULL, 'user_id' integer NOT NULL, 'points' integer NOT NULL DEFAULT (0) , 'lastAC' datetime);
CREATE TABLE 'contest_solved' ('contest_id' varchar(32) NOT NULL, 'user_id' integer NOT NULL, 'problem_id' varchar(64) NOT NULL);
CREATE TABLE 'contest_problems' ('contest_id' varchar(32) NOT NULL, 'problem_id' varchar(64) NOT NULL, 'name' varchar(256) NOT NULL, 'point_value' integer NOT NULL DEFAULT(0), 'category' varchar(64), 'flag' varchar(256) NOT NULL, 'draft' boolean NOT NULL DEFAULT(0));
CREATE TABLE 'problem_solved' ('user_id' integer NOT NULL, 'problem_id' varchar(64) NOT NULL);
INSERT INTO 'users' VALUES(1, 'admin', 'pbkdf2:sha256:150000$XoLKRd3I$2dbdacb6a37de2168298e419c6c54e768d242aee475aadf1fa9e6c30aa02997f', 'e', datetime('now'), 1, 0, 1, 0);
$ mkdir logs dl metadata metadata/contests metadata/problems metadata/announcements
$ python3 daily_tasks.py
$ cp default_settings.py settings.py
$ nano settings.py

In settings.py, you should add your email credentials as indicated by default_settings.py. Additionally, you may change the other email settings if you use a SMTP provider other than Gmail. Next, you should choose whether to use a CAPTCHA or not, and add your hCaptcha site and secret keys if you are using a CAPTCHA. Finally, you should add a custom name for your club and change any other settings that you wish to change.

Next, you should set up cron to run daily_tasks.py every day. Make sure daily_tasks.py is executable by running chmod +x daily_tasks.py. Then, run crontab -e and paste the following into the file: 0 0 * * * cd PATH_TO_INSTALL && ./daily_tasks.py, making sure you replace PATH_TO_INSTALL with the installation path.

Running in Debug Mode

$ export FLASK_APP=application.py
$ flask run

If you do not want to export the FLASK_APP every time you reset your terminal, you can create a symbolic link from app.py to application.py.

Do not expose the app to the web using debug mode. You should run the app through nginx, Apache, or a similar service.

Logging in for the first time

An admin account has been created in step 2. You can log in to it using the credentials admin:CTFOJadmin. Make sure you change your password immediately after logging in. Enabling 2FA is also recommended for the admin account. You can change your password and enable 2FA through the settings page.

You should also change the admin email manually so that you can reset your password in the future through the web app.

$ sqlite3 database.db
sqlite3>
UPDATE 'users' SET email='YOUR EMAIL HERE' WHERE id=1;

Furthermore, when regular users log in for the first time, they will be directed to a helloworld problem. You should create a helloworld problem as a welcome/landing page. This problem must have an id of 'helloworld', without the single quotes. You can do this on the 'Create Problem' page in the admin toolbar, once logged in. Markdown is supported. See below for an example helloworld problem:

**Welcome to CTF Club!** In each problem, you must find a flag hidden somewhere on the problem page.

The flag for this problem is: `CTF{your_first_ctf_flag}`

Optional Steps

You may optionally replace the default favicon.png file in the static folder with another icon of your choice (must be named favicon.png