Installing Symbolic Link Applications

Symbolic link (aka "symlink") applications are used to serve web content from a directory other than the root directory of an application. They work by creating a symlink pointing the desired directory.

Symlink apps are available in two varieties:

  • PHP-FPM+Apache (Symbolic Link) applications can serve PHP scripts and static content via Opalstack's shared back-end Apache server proxied behind the front-end Nginx server.
  • Nginx Static Only (Symbolic Link) applications can serve static content directly from the front-end Nginx server.

Installing a symlink app


Create a shell user if you have not done so already. You can use an existing shell user if you wish.


Click on Applications in the control panel sidebar.


Click the button labeled "+ Add Application" in the upper-left corner of the content area.


Select either "PHP-FPM+Apache (Symbolic Link)" or "Nginx Static Only (Symbolic Link)" as the application type


A panel of additional options will appear:

For PHP-FPM+Apache symlinks:

  • FPM Max Child Threads: this is the maximum number of processes that will run to serve your site. More processes generally means the application can handle more traffic, at the possible expense of higher memory usage.
  • FPM Max Requests: this is the number of requests that each process will serve before restarting. This can help keep memory usage down if your app's memory usage grows a lot over time, at the possible expense of performance.

For all symlink apps:

  • Symbolic Link Path: this is the path to the directory that you want to serve. For example, if your shell user is named myuser and you want to serve a directory named myfiles in the shell user's home directory, then you would enter /home/myuser/myfiles as the symlink path.

Enter a name for your application in the Name field.

This name will be used to create a symlink in your shell user's apps directory such as /home/username/apps/appname. The symlink will point to the directory that you specified in the Symbolic Link Path in the previous step.


Select the shell user that will host the application.

If you have multiple servers, be sure to select the shell user that is located on the server from which you intend to serve your site.


Click the "Add Application" button to save your new application.


A notification will appear in the control panel when the application is ready.