Install Guides

Full Install Guide
Static Install Guide


Bug tracker / Get help

Install Guide

  1. Download
  2. Setup your Database
  3. Edit configuration
  4. Upload the files
  5. Login and change your password


osFileManager requires PHP and MySQL. We strongly reccomend you install suPHP or suexec as it will protect the security of your files. Make sure you have these before trying to install and run it. If your webhost does not support PHP, MySQL, or suPHP, consider signing up for one that does.

Setup your Database

If you do not already have a database, it's time to make one now. If you are using cPanel, follow the directions below.

  1. Log into your cPanel account
  2. Go to Databases -> MySQL Databases
  3. Enter a new database name under "Create new database"
  4. Click "Create database"
  5. Return to the MySQL page
  6. Enter a username and password where it says "Add new user"
  7. Click "Create user"
  8. Return to the MySQL page
  9. Select your new user and your new database under where it says "Add user to database"
  10. Click Add

You can run the query below to create a database if you are not using cPanel or another GUI.


Now that the database is there, run the "users.sql" file that came with osFileManager. If you are using cPanel follow the directions below.

  1. In cPanel, go to Databases -> phpMyAdmin
  2. Click the new database that you created
  3. Click "SQL" at the top
  4. Paste the contents of "users.sql" into the text box
  5. Click "Go"

Edit configuration

All of the configuration info is stored in the main osFileManager file. Follow the steps below to configure it.

  1. Open "index.php" in your favorite text editor
  2. Find the "Config Section"
  3. In most cases "server" will need to be localhost. Otherwise set this to your MySQL server
  4. Set "user" to the username you created in the Setup your Database section
  5. Set "pass" to the password you set in the Setup your Database section
  6. Set "db" to the database you created in the Setup your Database section
  7. Save the file

Upload the files

  1. Log into your FTP or SSH account if you are a remote server
  2. Go to your web root directory. This is sometimes public_html
  3. Create a new directory called "osfm"
  4. Upload all the files that came with the osFileManager zip file up to yout webserver
  5. If you are not using suPHP: chmod any directory that you want to write or upload to to 0777
    This is insecure but the only way to do it without suPHP

Login and change your password

  1. Navigate to your osfm directory on your server in your browser.
    Ex: http://my.server.com/osfm/
  2. Login with username: admin, and password: password
  3. Navigate to "User CP" -> "Change password"
  4. Enter a new password for yourself and click Save