Download and Install CelerBuild

These instructions will guide you through downloading and installing the latest version of CelerBuild.

1. Download

First, determine the latest version of CelerBuild by visiting the CelerBuild official website (opens in a new tab).

Replace {VERSION} in the following commands with the actual latest version number.

macOS (darwin-amd64)

curl -O https://raw.githubusercontent.com/celerbuild/download/refs/heads/main/celerbuild-{VERSION}-darwin-amd64.tar.gz

Linux (x86_64)

curl -O https://raw.githubusercontent.com/celerbuild/download/refs/heads/main/celerbuild-{VERSION}-linux-amd64.tar.gz

Alternatively, you can download directly from the official website by clicking the download button for your operating system.

2. Extract the File

Run the following command to extract the file:

tar zxvf celerbuild-{VERSION}-{OS}-{ARCH}.tar.gz

Replace {OS} with either darwin or linux, and {ARCH} with your system architecture (e.g., amd64).

3. Set Permissions

Ensure the extracted file has execute permissions:

chmod +x celerbuild-{VERSION}-{OS}-{ARCH}

4. Run CelerBuild

Foreground Mode

./celerbuild-{VERSION}-{OS}-{ARCH}

Background Mode (Recommended for Production)

Using systemd (Linux)

Create log files and set permissions:

# Replace {USER} with your system user
sudo touch /var/log/celerbuild.log /var/log/celerbuild.error.log
sudo chown {USER}:{USER} /var/log/celerbuild.log /var/log/celerbuild.error.log

Create a systemd service file:

sudo nano /etc/systemd/system/celerbuild.service

Add the following content:

[Unit]
Description=CelerBuild Service
After=network.target
 
[Service]
Type=simple
User={USER}
Group={USER}
WorkingDirectory=/path/to/celerbuild-src
Environment="HOME=/home/{USER}"
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
ExecStart=/path/to/celerbuild-src/celerbuild-{VERSION}-linux-amd64
Restart=always
RestartSec=3
StandardOutput=append:/var/log/celerbuild.log
StandardError=append:/var/log/celerbuild.error.log
 
[Install]
WantedBy=multi-user.target

Replace the following placeholders:

{USER}: Your system username
/path/to/celerbuild-src: Actual path to CelerBuild directory
{VERSION}: CelerBuild version number

For example, on Ubuntu with user 'ubuntu':

[Unit]
Description=CelerBuild Service
After=network.target
 
[Service]
Type=simple
User=ubuntu
Group=ubuntu
WorkingDirectory=/home/ubuntu/celerbuild-src
Environment="HOME=/home/ubuntu"
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
ExecStart=/home/ubuntu/celerbuild-src/celerbuild-{VERSION}-linux-amd64
Restart=always
RestartSec=3
StandardOutput=append:/var/log/celerbuild.log
StandardError=append:/var/log/celerbuild.error.log
 
[Install]
WantedBy=multi-user.target

Set correct permissions:

sudo chown -R {USER}:{USER} /path/to/celerbuild-src
sudo chmod +x /path/to/celerbuild-src/celerbuild-{VERSION}-linux-amd64

Start the service:

sudo systemctl daemon-reload
sudo systemctl enable celerbuild
sudo systemctl start celerbuild

Verifying Successful Installation

After starting the service, verify it's running correctly:

Check service status:

sudo systemctl status celerbuild

You should see output similar to:

● celerbuild.service - CelerBuild Service
     Loaded: loaded
     Active: active (running)
     Main PID: [number]
     Tasks: 4
     Memory: ~8.5M

Key indicators of successful installation:

Status shows "active (running)"
No error messages in the output
Memory and CPU usage are stable

Verify the web interface:

# Check if the service is listening
curl -I http://localhost:8666

Monitor the service:

# View real-time logs
tail -f /var/log/celerbuild.log
 
# Check resource usage
sudo systemctl status celerbuild --no-pager

The service is now properly installed and running. You can proceed to:

Access the web interface at http://your-server:8666 (opens in a new tab)
Complete the activation process
Configure your database settings

Troubleshooting

If you encounter issues:

Check the logs:

tail -f /var/log/celerbuild.log /var/log/celerbuild.error.log

Check process status:

ps aux | grep celerbuild

⚠️

Common issues and solutions:

Permission errors: Verify user/group settings
Path issues: Ensure all paths in service file are correct
Service not starting: Check logs for detailed error messages

Next Steps

After successful installation:

Dependencies Activation