Deployment

​

Overview

Enferno provides multiple deployment options to suit different needs. You can either use the automated Enferno CLI tool for quick Ubuntu server deployments, or follow the traditional deployment process for other environments.

​

Automated Deployment (Recommended)

The Enferno CLI tool automates the entire deployment process on Ubuntu servers with a single command.

​

Features

• Automated server provisioning with Python 3.13+ support
• Nginx configuration with SSL certificates
• PostgreSQL/SQLite database setup
• Systemd services configuration
• User management and security setup

​

Quick Start

1. Install the CLI tool:

pip install enferno_cli

2. Run the interactive setup:

enferno setup

The tool will guide you through the configuration process, prompting for necessary information like server hostname, credentials, and deployment options.

​

Traditional Deployment

If you prefer manual deployment or need to deploy to a different environment, follow these steps:

​

Prerequisites

1. Python 3.11+
2. PostgreSQL or SQLite
3. Redis
4. Nginx
5. Systemd (for service management)
6. uv (fast Python package installer)

​

Server Setup

1. Update system packages:

sudo apt update
sudo apt upgrade -y

2. Install dependencies:

sudo apt install -y python3-pip python3-venv nginx redis-server

3. Install uv:

pip install uv

4. Install PostgreSQL (optional):

sudo apt install -y postgresql postgresql-contrib

​

Application Setup

1. Clone and setup:

git clone https://github.com/level09/enferno.git
cd enferno
./setup.sh  # Creates Python environment, installs requirements, and generates secure .env

2. Initialize database:

source .venv/bin/activate
flask create-db  # Setup database
flask install    # Create admin user

​

Database Configuration

Enferno supports both SQLite (default) and PostgreSQL databases. Choose one of the following options:

​

SQLite (Default)

No additional configuration needed. The database will be created automatically when you run:

flask create-db  # Initialize database
flask install    # Create admin user

​

PostgreSQL

1. Create database and user:

sudo -u postgres createuser -s myuser
sudo -u postgres createdb mydb

2. Update .env configuration:

SQLALCHEMY_DATABASE_URI=postgresql://myuser:password@localhost/mydb

3. Initialize database:

flask create-db  # Initialize database
flask install    # Create admin user

​

Nginx Configuration

Create a new Nginx configuration:

server {
    listen 80;
    server_name yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:5000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }

    location /static {
        alias /path/to/enferno/static;
        expires 30d;
    }
}

​

SSL Configuration

1. Install Certbot:

sudo apt install -y certbot python3-certbot-nginx

2. Obtain SSL certificate:

sudo certbot --nginx -d yourdomain.com

​

Systemd Service

Create a service file /etc/systemd/system/enferno.service:

[Unit]
Description=Enferno Web Application
After=network.target

[Service]
User=your_user
WorkingDirectory=/path/to/enferno
Environment="PATH=/path/to/enferno/venv/bin"
ExecStart=/path/to/enferno/venv/bin/gunicorn -w 4 -b 127.0.0.1:5000 wsgi:app

[Install]
WantedBy=multi-user.target

Enable and start the service:

sudo systemctl enable enferno
sudo systemctl start enferno

​

Celery Worker Service

Create /etc/systemd/system/enferno-celery.service:

[Unit]
Description=Enferno Celery Worker
After=network.target

[Service]
User=your_user
WorkingDirectory=/path/to/enferno
Environment="PATH=/path/to/enferno/venv/bin"
ExecStart=/path/to/enferno/venv/bin/celery -A enferno.tasks worker --loglevel=info

[Install]
WantedBy=multi-user.target

Enable and start the worker:

sudo systemctl enable enferno-celery
sudo systemctl start enferno-celery

​

Production Checklist

• Set FLASK_DEBUG=0 in .env
• Use a secure SECRET_KEY
• Configure proper logging
• Set up monitoring (e.g., Sentry)
• Configure backup strategy
• Set up firewall rules
• Enable rate limiting
• Configure CORS settings
• Set secure cookie flags
• Enable HTTPS redirection

​

Troubleshooting

​

Common Issues

1. Static files not found (404)

   • Check Nginx static file path configuration
   • Verify file permissions
   • Run flask static to collect static files

2. Database connection errors

   • Verify database credentials in .env
   • Check database service status
   • Ensure proper permissions

3. Application not starting

   • Check systemd service logs: sudo journalctl -u enferno
   • Verify environment variables
   • Check application logs

4. Redis connection issues

   • Verify Redis is running: sudo systemctl status redis
   • Check Redis connection settings
   • Ensure proper permissions

For more deployment options and troubleshooting, visit the Enferno CLI documentation.