Bakmiup Setup

Necessary Prerequisites

  • Apache
  • PHP
  • MySQL
  • Perl (with the following Modules)
    • Ragnarok
  • Git
  • openSSH
For 3rd party software that has configuration options (like openSSH), use the configuration files found in Bakmiup: Recommended Settings for 3rd Party Software instead of the defaults.

Recommended Prerequisites

  • A static ip address

Windows Git Installation For bakmiup

To install Git for bakmiup, make sure that you overwrite the Windows tools when installing (this is the third option in the set of options during installation). Everything else, leave as the default.


Depending on the distribution of Linux you choose for the bakmiup server, the instructions for installing software are very different. Consult your distribution's manual to install all the necessary prerequisites.

Because git is installed on the server, we can use it to get the most recent version of bakmiup. Note, due to the variable location of the Document Root of the webserver, we will use the generic /webserver to describe the webserver's Document Root (it is usually one of the following: /var/www, /var/www/html, /srv/http, /home/www/, /home/www/html).

cd /webserver
git clone
cd bakmiup
yes | rm -R .git

Because you will not be committing changes to the repository, you do not need the .git directory. .gitignore and .gitignore_global are unnecessary to the execution of bakmiup on the server, but are there in case you ever do decide to contribute to the upstream (these files ensure that your custom configurations will remain private).

Now edit the configuration-template.php file with the correct data and save it as configuration.php (every update overwrites configuration-template.php) (see #Configuration for more information). Make sure that the webserver and database server are running.

Open a web browser and navigate to your sever's ip address. If you are running on the local server, navigate to This will run the setup script. Refresh the page and you see a message telling you to execute This script fixes any problems that the program cannot fix itself. To run this, you must be root:

cd /webserver/bakmiup

Once you successfully execute this script, you can refresh the page and see that you are able to log in.


The configuration template has a few options that must be filled out. They are structured into four sections:

  1. Internals
  2. Updating
  3. UI Preferences
  4. SSH Server Settings
To get bakmiup online doing the bare minimum, you need to edit the following:

  • $GLOBALS['drive'] in Internals
  • $GLOBALS['registrationOpen'] in UI Preferences
  • $GLOBALS['server'] in SSH Server Settings
  • $GLOBALS['port'] in SSH Server Settings


$GLOBALS['drive'] is a subdirectory that will contain all the backups. Depending on how much space you need, it might be smart to put it on a dedicated raid array, it's own partition, or on an external drive. If you move it off disk or outside of the /webserver/bakmiup directory, you need to create a symlink (see Bakmiup:Skills#Setting_up_a_Symlink for more information).


$GLOBALS['registrationOpen'] is a boolean value that tells the login page to display a registration form. If this is set to false, no registration form is visible or processable.


$GLOBALS['server'] is the vehicle in which the program accesses the server. If you have a domain name for this server, you can use that domain name. If not, you can use a static ip address. Before setting the server configuration, test to make sure that you can go to $GLOBALS['server']/bakmiup (ie and access bakmiup.


$GLOBALS['port'] tells the computer the correct door to the server. If you think of the server as a building, to get to the right office, you need to know the door, or the port. The port is set in the sshd_config file; the setting must be the same as the number in that file.


Edit | Attach | Watch | Print version | History: r2 < r1 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r2 - 2014-12-28 - ZachBornheimer
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2021 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback