Portals for Tableau 101: Containerizing Your Portal


Portals for Tableau 101: Containerizing Your Portal

Portals for Tableau 101 shares the basics of interacting with InterWorks' embedded analytics solution, Portals for Tableau.

Please note that Portals for Tableau are now officially known as Curator by InterWorks. You can learn more at the official Curator website.

While it isn’t our recommended approach, Portals for Tableau can be hosted in a container environment, such as Docker. There be dragons with this process, so consider this your dragon-slaying guide.

Persistent Database and Filesystem

Portals for Tableau uses a small database to house your portal’s configuration. This database and its data need to persist between rebuilds of your container. While the portal code itself can be rebuilt within a container, the portal stores uploaded files to the storage/app/ folder in your portal’s web root directory. This folder will need to be retained between rebuilds of the container.

Portal Configuration and Upgrades

The portal’s configuration files don’t need to be persistent; however, it is important to retain the database encryption key from the config/app.php configuration file across rebuilds. If not, you will lose the ability to decrypt existing data from the database.

There are three parts to a portal upgrade that happen during a normal 1-click upgrade. These will need to be accounted for in your container environment to prevent rebuilds from reverting to the previous version of your portal. In fact, when hosting Portals for Tableau in a containerized manner, it’s recommended to disable all upgrades through the interface for this reason.

  • Kernel Updates

Portals for Tableau uses an underlying kernel, called October, to provide a framework upon which everything is built. To update the kernel, the following zip archive will need to be downloaded, extracted and the contents copied over the web root directory of your portal:


  • Portal Updates

The core portal functionality uses the kernel’s framework to add all the functionality you know and love. To update the portal code, use the manual update link found in your portal to download the zip archive. It will need to be extracted and everything inside of the core/ folder of that extract copied over the web root directory of your portal:

containerizing your Portal for Tableau

  • Database Updates

As features are added to Portals for Tableau, small tweaks to the database need to be made. These database updates are included as migration scripts in the above code updates. Once the kernel and core portal have been updated, the database migration scripts can be executed by running the following command from the portal’s web root folder:

php artisan october:up

More About the Author

Matthew Orr

Curator Engineer
Portals for Tableau Feature Expansion: Content Tracking While we definitely recommend using a web analytics tracker, such as Google Analytics or Matomo, to track usage of your portal, the ...
Portals for Tableau New Feature Spotlight: Content Favoriting [cue music] Tiles on pages and bar charts on dashboards, Publishing files and tagging with keywords, Centralization through external ...

See more from this author →

Subscribe to our newsletter

  • I understand that InterWorks will use the data provided for the purpose of communication and the administration my request. InterWorks will never disclose or sell any personal data except where required to do so by law. Finally, I understand that future communications related topics and events may be sent from InterWorks, but I can opt-out at any time.
  • This field is for validation purposes and should be left unchanged.

InterWorks uses cookies to allow us to better understand how the site is used. By continuing to use this site, you consent to this policy. Review Policy OK


Interworks GmbH
Ratinger Straße 9
40213 Düsseldorf
Geschäftsführer: Mel Stephenson

Kontaktaufnahme: markus@interworks.eu
Telefon: +49 (0)211 5408 5301

Amtsgericht Düsseldorf HRB 79752
UstldNr: DE 313 353 072