Amber Framework
WebsiteBlogGithubGitter
Search…
Introduction
Getting Started
Guides
Overview
Installation
Create New App
Directory Structure
Configuration
Docker
Controllers
Views
Models
Routing
Websockets
Mailers
Testing
Deployment
CLI
Examples
Cookbook
Troubleshooting
In Production
Contributing
Code of Conduct
HAVE A QUESTION?
Ask on Gitter
Ask on StackOverflow
Follow on Twitter
Submit an issue
Powered By GitBook
Installation
That feeling you get when that right tool did all the work
The Amber CLI offers you a set of command line tools to create, generate, scaffold and run your projects quickly and simply.

Linux

Ensure you have the necessary dependencies:
  • Git: Use your platform specific package manager to install git
  • Crystal: Follow the instructions to get crystal on this page: Crystal Installation​
  • NodeJS and Webpack: node is an optional dependency and is used to compile JavaScript and other assets.
  • PostgreSQL: postgres is a relational database server. Amber configures applications to use this database adapter by default, but you can switch to MySQL by passing the flag --database mysql when creating a new application.
Once you have these dependencies, You can build the amber tool from source:

From Source

Download and install amber
1
curl -L https://github.com/amberframework/amber/archive/stable.tar.gz | tar xz
2
cd amber-stable/
3
make
4
sudo make install
Copied!
If you run into an issue on compilation regarding Unhandled exception in spawn: fork: Cannot allocate memory it means you don't have enough memory. This can easily be solved by adding a swapfile.
1
sudo dd if=/dev/zero of=/swapfile bs=2k count=1024k
2
sudo mkswap /swapfile
3
sudo chmod 600 /swapfile
4
sudo swapon /swapfile
Copied!

For Debian & Ubuntu

  • These are necessary to compile the CLI:
  • sudo apt-get install build-essential libreadline-dev libsqlite3-dev libpq-dev libmysqlclient-dev libssl-dev libyaml-dev

For RedHat & CentOS

  • sudo yum groupinstall development tools
  • sudo yum install readline-devel sqlite-devel openssl-devel libyaml-devel gc-devel libevent-devel

For ArchLinux & derivates

  • Install the CLI from AUR package. Dependencies are automatically installed.
  • yaourt -S amber
You should now be able to run amber in the command line.

macOS

Installing Amber with these package managers also installs Crystal.
  • Homebrew
    1
    brew tap amberframework/amber
    2
    brew install amber
    Copied!
  • MacPorts
    1
    sudo port selfupdate
    2
    sudo port install amber
    Copied!

From source

Known problems while trying to build Amber from source on macOS:
  • If you see linker problems, such as ld: library not found for -lssl (this usually means you need to install the development package for libssl), you may need to set some (or all) of those environment variables:
    1
    export PKG_CONFIG_PATH="/usr/local/opt/openssl/lib/pkgconfig"
    2
    export LDFLAGS="-L/usr/local/opt/openssl/lib"
    3
    export CPPFLAGS="-I/usr/local/opt/openssl/include"
    Copied!
Previous
Overview
Next
Create New App
Last modified 8mo ago
Copy link
Contents
Linux
From Source
For Debian & Ubuntu
For RedHat & CentOS
For ArchLinux & derivates
macOS
From source