Skip to content
Jordan Dalby edited this page Nov 25, 2024 · 3 revisions

FAQ

Sorting & Filtering Options

ByteStash offers a bunch of nice-to-have filtering options, all options can be mix and matched, to really narrow things down:-

  • Filter by Search
    • The search bar can filter snippets by name, description, and (optionally) code
    • The search bar can also be used to filter by category, type #category-name, then press enter to accept, multiple categories can be filtered at once
  • Filter by Language
    • The languages dropdown can be used to search for snippets by language, the list contains every language in the available snippets
  • Sort by Time
    • Order your snippets by update date so you can easily find new snippets

Plans:-

  • Order snippets alphabetically by name

Settings

ByteStash can be configured to your liking all via the settings menu located in the top right of the main screen, see below for the settings and their descriptions:-

  • Compact View
    • Reduces the footprint of the snippet previews
  • Show Code Preview
    • Should the snippets show a code preview?
  • Preview Lines
    • Only available if Show Code Preview is enabled
    • How many lines of code should be displayed? (1-20)
  • Include Code in Search Queries
    • When searching with the search bar, should code be included in the search?
    • Can be disabled to narrow down a search, especially if your search contains a commonly used syntax word
  • Show Categories
    • Should categories be shown on the snippet previews?
    • Categories will still be shown in the expanded snippet view
  • Expand Categories
    • When the number of categories exceeds the screen size limit, they are normally truncated with a "Show all" button, this setting will automatically show all by default
  • Show Line Numbers
    • Should line numbers be displayed in code previews / the code editor?
    • Does not work with Markdown, since this is rendered independently

Environment Variables

ByteStash has a few configurable environment variables used for various things:-

  • BASE_PATH
    • Use if you want a base path, e.g. enter /bytestash for a base path that points to my.domain/bytestash, leave blank in most cases
  • JWT_SECRET_FILE
    • For use with Docker secrets, if you don't know what that is use the below option instead
  • JWT_SECRET
    • Your JWT secret, generate your own and replace the value
  • ALLOW_NEW_ACCOUNTS
    • true or false
    • Is this bytestash instance open to new accounts?
  • DEBUG
    • true or false
    • In most cases leave as false, it's useful for debugging issues
  • DISABLE_ACCOUNTS
    • true or false
    • Totally disable user accounts, any existing accounts will persist so you can switch back at any time
    • Acts as one user, you will be automatically authenticated as that user bypassing the login / registration screen
  • DISABLE_INTERNAL_ACCOUNTS
    • true or false
    • Disable internal accounts, this includes existing accounts
    • Useful if you only want SSO logins
Clone this wiki locally