Splunk Developer FAQs

If you have a question about Splunkbase that goes beyond the list below, visit Splunk Answers or send us an email.

Manage your app

Manage statistics

Certify an app

Manage your app

  1. How do I delete a release of my app?

    1. Log into your Splunkbase account.
    2. Navigate to your app or add-on, and click Manage App.
    3. Navigate to the release that you want to delete, then click Edit Release.
    4. On the Edit Release page, click Delete.
  2. How do I delete my app?

    Login using admin privileges on your app, then click the Request App Deletion button at the bottom of the page.

  3. Why doesn't my app icon display?

    Your app displays a transparent .png file over a white background. Unless you specify otherwise, white is the default background color. You can fix the issue in two ways:

    1. Change the background color in default/data/ui/nav/default.xml in your app package. For example:
      <nav search_view="search" color="#000000">
    2. Upload an icon that replaces the transparency with a different color. See Add navigation to a Splunk app to learn more.
  4. How do I resolve the error "only one item is allowed in root directory"?

    Your submitted package extracts into more than one folder. This happens when you package your submission so the file structure of your content has multiple root files or folders despite only resulting in a single folder when extracted. To resolve, package your submission with only one folder in the root directory.

  5. How do I resolve the error "Hidden files that start with . are not allowed"?

    Some operating systems create a hidden file when you use a GUI file manager to browse files. For example, Mac OS includes a .DS_store hidden file. When packaging a tarball from the command line, omit the hidden files: COPYFILE_DISABLE=1 tar cv --exclude='*DS_Store' $1 > $1.tar

  6. How do I update my app icon?

    For apps hosted on Splunkbase, you need to include the app icon within the package. The default version of your app is the one that displays the app icon that Splunkbase. For more information, see Icons in the "Package and publish a Splunk app" topic. For apps hosted externally, the Splunkbase, you can manage the app icon from the app edit page. Note that you still need to include the icon within the app package so the app displays properly in Splunk Enterprise.

  7. I want to change the app id of my app but keep getting an error when I try to upload a new version. How do I change the app id of my app?

    Do not change the app id. Splunkbase uses the app id as a unique identifier and is necessary for collecting statistics about your app. Consider uploading your package as a new app and make a request to delete the original app.

  8. How do I change the app owner display name for my app?

    You can change the app owner display name, located under "Built By" on your app's display page, in one of two ways:

    • Create a new account using your company name, then make a request to transfer ownership.
    • Change the display name of your current account.
      1. Log in to your Splunk account at splunk.com.
      2. Under My Account, click Edit Login and Email Subscriptions.
      3. Save your changes.
      4. Log out, then log back in to apply the name change update.
  9. I want to make a minor revision to an existing app that on Splunkbase. Can I make a revision while keeping the same version number?

    Yes. You need to make sure the app has at least one available version.

    1. Upload a placeholder release with a separate version number.
    2. Set the placeholder as the default version.
    3. Delete the original version.
    4. Upload the revised package with the original version name.
    5. Set the newly uploaded package as default then delete the placeholder.
  10. How do I get access to leads for my app?

    App administrators can access leads from the app admin tools. Navigate to Access download leads, then follow the instructions. Note that you can only see leads where users agreed to share their information.

  11. How do I change the background color of my app icon?

    Change the background color in default/data/ui/nav/default.xml in your app package. For example:

    <nav search_view="search" color="#000000">

Manage statistics

  1. What does "install count" mean?

    When a user installs your app from a valid instance of Splunk Enterprise, the app pings home with information about the installation and Splunkbase counts an install of your app. Splunkbase increments the count based on unique Splunk Enterprise instances.

  2. Does the app install count have duplicate counts when users update my app or reinstall it in their Splunk instance?

    Splunkbase does not "double-count" the app updates and reinstallations your users make. Splunkbase increments the count based on unique Splunk Enterprise instances.

  3. How do I convert my externally-hosted directory listing app to one hosted on Splunkbase?

    Login using admin privileges on your app, then click the Contact Us link at the bottom of the page to request conversion.

  4. How do I monetize my app?

    See the Monetize and license your content section of the Splunk Answers and Splunkbase manual.

  5. How do I create a Splunkbase account?

    Your Splunk.com account works on Splunkbase. To create a splunk.com account, navigate to the sign up page and follow the instructions to create an account.

  6. How do I reset my Splunkbase login password?

    Navigate to the sign up page and follow the instructions to reset your password.

  7. Are there instructions for app packaging and distribution?

    See the Package and publish a Splunk app documentation.

  8. Why are the number of leads and the number of app downloads different?

    Splunkbase only collects leads from users who have consented to provide their contact information. Users can choose to opt out of sharing this information by unchecking the box labeled "I consent to Splunk sharing my contact information with the publisher of this app so I can receive more information about the app directly from the publisher". Splunkbase does not require user consent to count the number of downloads.

Certify an app

  1. How do I get my app certified?

    1. Login to your app using admin privileges.
    2. Navigate to the Hosting page, then click the Request Certification checkbox.
    3. Click the Submit button.

    Learn more about certification in the App certification documentation.