GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
REGGAE(1) FreeBSD General Commands Manual REGGAE(1)

reggae
REGister Globaly Access Everywhere is a package which helps in common DevOps tasks

reggae <command>

Reggae is an open source package which relays on CBSD to provide lower level management for jails and virtual machines.

If you have ever used Vagrant or Docker Compose, Reggae is best described as an alternative to those. It enables you easy development inside jail while code editing is done on the host. It makes transition from development to production easier by using provisioners. It makes host clean of all requirements of development and puts them inside jail which is easily stopped, started, provisioned, and destroyed.

To initialize Reggae run the following as root:

reggae network-init
# service pflog restart
# service pf restart
service sshd restart
reggae cbsd-init
reggae master-init

PF is initialized only if /etc/pf.conf doesn't exist already. In those cases PF services should be restarted.

Through config file in /usr/local/etc/reggae.conf you can change values for anything Reggae is using. reggae network-init will make sure sshd is listening to lo0 on hosts with dynamic IP, and on lo0 and egress if the IP is static. This way host sshd doesn't have a conflict with the jailed one. Also, if IP is dynamic, PF will be configured so it redirects all requests for SSH on egress to lo0. One of the advantages is that you can use ssh's ProxyCommand to login to jail, even though jail is behind NAT.

Ater reggae master-init, you'll get two master jails: DHCP and DNS. They are used to lease IPs to virtual machines and to register all resources in DNS so that you can use FQDN instead of IP addresses. The DNS jail IP is used in /etc/resolvconf.conf if host has dynamic IP on egress, so that changes of network parameters are passed to the appropriate jail. Also, host will use DNS jail IP in /etc/resolv.conf. In short, it enables you to not remember jail IPs when you have to use them, but use <jail name>.<domain> to reference them, in which case comes from /usr/local/etc/reggae.conf.

reggae-init(1) reggae-project(1) reggae-project-init(1) reggae-provision(1) reggae-register(1) reggae-service(1)

Report bugs to https://github.com/mekanix/reggae/issues.

Goran Mekić <meka@tilda.center>
May 20, 2018 FreeBSD 13.1-RELEASE

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.