Download CelerBuild

CelerBuild provides multiple installation methods. Choose the one that best suits your needs.

Quick Installation Methods

1. Quick Install with curl

Automatically detect your OS and architecture:

# Auto Install (macOS & Linux)
curl -fsSL https://raw.githubusercontent.com/celerbuild/download/refs/heads/main/install.sh | sh

Or install manually:

# Download install script
curl -O https://raw.githubusercontent.com/celerbuild/download/refs/heads/main/install.sh
# Make it executable
chmod +x install.sh
# Run install script
./install.sh

The script will install CelerBuild to /usr/local/bin/celerbuild

Run CelerBuild

  1. Foreground Mode:
celerbuild
  1. Background Mode (Recommended for Production):

For Linux (using systemd):

# Create service file
sudo tee /etc/systemd/system/celerbuild.service << EOF
[Unit]
Description=CelerBuild Service
After=network.target
 
[Service]
Type=simple
User=$USER
ExecStart=/usr/local/bin/celerbuild
Restart=always
RestartSec=3
 
[Install]
WantedBy=multi-user.target
EOF
 
# Start service
sudo systemctl daemon-reload
sudo systemctl enable celerbuild
sudo systemctl start celerbuild
 
# Manage service
sudo systemctl status celerbuild  # Check status
sudo systemctl stop celerbuild    # Stop service
sudo systemctl restart celerbuild # Restart service

For macOS (using launchd):

# Create launch agent file
mkdir -p ~/Library/LaunchAgents
cat > ~/Library/LaunchAgents/com.celerbuild.plist << EOF
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.celerbuild</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/celerbuild</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>
EOF
 
# Manage service
launchctl load ~/Library/LaunchAgents/com.celerbuild.plist   # Start service
launchctl unload ~/Library/LaunchAgents/com.celerbuild.plist # Stop service
launchctl list | grep celerbuild                             # Check status

2. Quick Install with Homebrew

For macOS users:

# Install via Homebrew
brew tap celerbuild/celerbuild
brew install celerbuild

Requires Homebrew (opens in a new tab) package manager

Verify Installation

celerbuild -version

Run CelerBuild

# Run directly
celerbuild
 
# Or manage as a service
brew services start celerbuild   # Start service
brew services stop celerbuild    # Stop service
brew services restart celerbuild # Restart service

Manual Download and Installation

If you prefer to download and install manually, follow these steps:

1. Download

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

The download URL format is:

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

Where:

  • {VERSION}: CelerBuild version (e.g., 0.8.8)
  • {OS}: Operating system
    • darwin (macOS)
    • linux (Linux)
  • {ARCH}: CPU architecture
    • amd64 (Intel/AMD 64-bit)
    • arm64 (ARM 64-bit)

For macOS with Intel/AMD CPU:

# macOS AMD64 example (version 0.8.8)
curl -O https://raw.githubusercontent.com/celerbuild/download/refs/heads/main/celerbuild-0.8.8-darwin-amd64.tar.gz

For macOS with Apple Silicon (M1/M2):

# macOS ARM64 example (version 0.8.8)
curl -O https://raw.githubusercontent.com/celerbuild/download/refs/heads/main/celerbuild-0.8.8-darwin-arm64.tar.gz

For Linux with Intel/AMD CPU:

# Linux AMD64 example (version 0.8.8)
curl -O https://raw.githubusercontent.com/celerbuild/download/refs/heads/main/celerbuild-0.8.8-linux-amd64.tar.gz

For Linux with ARM CPU:

# Linux ARM64 example (version 0.8.8)
curl -O https://raw.githubusercontent.com/celerbuild/download/refs/heads/main/celerbuild-0.8.8-linux-arm64.tar.gz

Download Options

  1. Direct Download:
curl -O https://raw.githubusercontent.com/celerbuild/download/refs/heads/main/celerbuild-0.8.8-darwin-amd64.tar.gz
  1. Alternative Download Methods:

Troubleshooting Download Issues

If you encounter connection issues with githubusercontent.com:

Alternative solutions:

  • Use a VPN
  • Use alternative DNS servers
  • Download directly from our official website

Verify Download

After downloading, verify the file integrity using SHA256 checksum:

  1. Get the checksum:
# For macOS
shasum -a 256 celerbuild-0.8.8-darwin-amd64.tar.gz
 
# For Linux
sha256sum celerbuild-0.8.8-linux-amd64.tar.gz
  1. Compare with the official checksum:
# macOS (darwin-amd64)
7c35b8a779bdbbbf41315ae95505e55de3e4ea0048be89049ddf67c23d7f8c2d  celerbuild-0.8.8-darwin-amd64.tar.gz

# Linux (amd64)
ca5ba325c98723c3524a86a2065ed911debaa30c33871c656e229f2b2cd0a11d  celerbuild-0.8.8-linux-amd64.tar.gz

The checksums should match exactly. If they don't, the download may be corrupted or tampered with.

2. Extract the File

# For macOS with Intel CPU (example)
tar zxvf celerbuild-0.8.8-darwin-amd64.tar.gz
 
# For macOS with Apple Silicon (example)
tar zxvf celerbuild-0.8.8-darwin-arm64.tar.gz
 
# For Linux with Intel CPU (example)
tar zxvf celerbuild-0.8.8-linux-amd64.tar.gz

3. Set Permissions

# For macOS with Intel CPU (example)
chmod +x celerbuild-0.8.8-darwin-amd64
 
# For Linux with Intel CPU (example)
chmod +x celerbuild-0.8.8-linux-amd64

4. Run CelerBuild

Foreground Mode

# For macOS with Intel CPU (example)
./celerbuild-0.8.8-darwin-amd64
 
# For Linux with Intel CPU (example)
./celerbuild-0.8.8-linux-amd64

Background Mode (Recommended for Production)

Using systemd (Linux)
  1. 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
  1. Create a systemd service file:
sudo nano /etc/systemd/system/celerbuild.service
  1. 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
  1. Set correct permissions:
sudo chown -R {USER}:{USER} /path/to/celerbuild-src
sudo chmod +x /path/to/celerbuild-src/celerbuild-{VERSION}-linux-amd64
  1. 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:

  1. 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
  1. Verify the web interface:
# Check if the service is listening
curl -I http://localhost:8666
  1. 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:

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

Troubleshooting

If you encounter issues:

  1. Check the logs:
tail -f /var/log/celerbuild.log /var/log/celerbuild.error.log
  1. 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 downloading and setting up CelerBuild:

  1. Database Configure

  2. Activation

DependenciesDatabase Configuration