Installing Mejiro on Ubuntu Server

Mejiro is a web application that simplifies the process of submitting data to the GenBank database. This tutorial will guide you through the installation process on Ubuntu Server.

Prerequisites

  • Ubuntu Server (latest version)
  • Python 3.6 or higher
  • Git
  • Pip
  • Virtualenv

Step 1: Clone Mejiro Repository

Clone the Mejiro repository from Github by running the following command:

$ git clone https://github.com/dmpop/mejiro.git

Step 2: Create a Virtual Environment

Create a virtual environment for Mejiro to run in by running the following command:

$ virtualenv -p python3.6 env

Step 3: Activate the Virtual Environment

Activate the virtual environment by running the following command:

$ source env/bin/activate

Step 4: Install Required Packages

Install the required packages by running the following command:

$ pip install -r requirements.txt

Step 5: Configure Mejiro

Create a .env file in the Mejiro directory by running the following command:

$ touch .env

Open the .env file and add the following variables:

DATABASE_URL=<database-url>
SECRET_KEY=<secret-key>
EMAIL_HOST=<email-host>
EMAIL_PORT=<email-port>
EMAIL_HOST_USER=<email-username>
EMAIL_HOST_PASSWORD=<email-password>

Replace the variables with your own values.

Step 6: Create the Database

Create a new PostgreSQL database by running the following command:

$ sudo su postgres
$ psql
postgres# CREATE USER mejiro WITH PASSWORD '<db-password>';
postgres# CREATE DATABASE mejiro_db;
postgres# GRANT ALL PRIVILEGES ON DATABASE mejiro_db TO mejiro;
postgres# \q

Replace <db-password> with a strong password.

Step 7: Migrate the Database

Run the following command to migrate the database:

$ python manage.py migrate

Step 8: Create a Superuser

Create a superuser account by running the following command:

$ python manage.py createsuperuser

Follow the prompts to set up the account.

Step 9: Run Mejiro

Finally, run Mejiro by executing the following command:

$ python manage.py runserver

You can now access Mejiro by navigating to http://localhost:8000 in your web browser.

That's it! You have successfully installed Mejiro on Ubuntu Server.